🎵 风雪音乐站 API 接口文档

风雪整理编写，使用的音乐接口均收集与网络，用于学习和测试，不能用于商业，本人不承担任何法律责任。

来源：http://qjjlb.quanjian.com.cn/musicdl/
支持4个音乐源：咪咕、网易云、QQ音乐、酷我

1. 咪咕音乐（migu）

1.1 搜索

GET https://api.xcvts.cn/api/music/migu

参数	类型	必填	说明
`gm`	string	是	搜索关键词，需 URL 编码
`n`	string	否	歌曲序号（搜索时留空，获取详情时填具体序号）
`num`	string	是	返回数量
`type`	string	是	固定值 `json`

搜索请求示例：

GET https://api.xcvts.cn/api/music/migu?gm=晴天&n=&num=10&type=json

搜索响应：

{
  "code": 200,
  "data": [
    {
      "n": 1,
      "title": "晴天",
      "singer": "周杰伦"
    },
    {
      "n": 2,
      "title": "晴天（钢琴版）",
      "singer": "佚名"
    }
  ]
}

字段	类型	说明
`code`	int	状态码，200=成功
`data`	array	搜索结果列表
`data[].n`	int	歌曲序号（用于详情请求的 n 参数）
`data[].title`	string	歌曲名
`data[].singer`	string	歌手名

1.2 获取详情（播放URL + 歌词URL）

GET https://api.xcvts.cn/api/music/migu

参数	类型	必填	说明
`gm`	string	是	与搜索时相同的关键词
`n`	string	是	搜索结果中的歌曲序号（如 `1`）
`num`	string	是	与搜索时相同的数量
`type`	string	是	固定值 `json`

详情请求示例：

GET https://api.xcvts.cn/api/music/migu?gm=晴天&n=1&num=10&type=json

详情响应：

{
  "code": 200,
  "title": "晴天",
  "singer": "周杰伦",
  "cover": "https://d.musicapp.migu.cn/...",
  "lrc_url": "https://music.migu.cn/...",
  "link": "https://music.migu.cn/v3/music/song/60054701923",
  "music_url": "https://freetds.migu.cn/..."
}

字段	类型	说明
`code`	int	200=成功
`title`	string	歌曲名
`singer`	string	歌手名
`cover`	string	封面图URL
`lrc_url`	string	歌词URL（可能为空）
`link`	string	咪咕歌曲页面URL
`music_url`	string	音频播放/下载URL（可能为空，表示无法获取）

⚠️ 注意：咪咕详情返回的 music_url 和 lrc_url 经常为空字符串，成功获取不稳定。

2. 网易云音乐（netease）

2.1 搜索

GET https://api.vkeys.cn/v2/music/netease

参数	类型	必填	说明
`word`	string	是	搜索关键词，需 URL 编码
`page`	int	是	页码，从1开始
`num`	int	是	每页数量

请求示例：

GET https://api.vkeys.cn/v2/music/netease?word=晴天&page=1&num=10

响应：

{
  "code": 200,
  "message": "请求成功！",
  "data": [
    {
      "id": 3339230677,
      "song": "晴天",
      "singer": "周杰伦",
      "album": "叶惠美",
      "time": "2003-07-31",
      "quality": "高清臻音（Spatial Autio）",
      "cover": "http://p3.music.126.net/..."
    }
  ]
}

字段	类型	说明
`code`	int	200=成功
`message`	string	状态描述
`data`	array	搜索结果列表
`data[].id`	int	歌曲ID（唯一标识）
`data[].song`	string	歌曲名
`data[].singer`	string	歌手名
`data[].album`	string	专辑名
`data[].time`	string	发布日期
`data[].quality`	string	音质描述
`data[].cover`	string	封面图URL

⚠️ 注意：网易云 API 仅提供搜索，不提供播放URL和歌词URL。该源在原站中也无法获取详情。

目前音乐站已经更换为我个人的VIP账户，个人账户提供播放URL和歌词，仅供个人使用！。

3. QQ音乐

3.1 搜索

GET https://tang.api.s01s.cn/music_open_api.php

参数	类型	必填	说明
`msg`	string	是	搜索关键词，需 URL 编码
`type`	string	是	固定值 `json`

请求示例：

GET https://tang.api.s01s.cn/music_open_api.php?msg=晴天&type=json

响应：

[
  {
    "song_title": "晴天",
    "pay": "付费",
    "song_mid": "0039MnYb0qxYhV",
    "singer_name": "周杰伦"
  },
  {
    "song_title": "晴天 (Live)",
    "pay": "付费",
    "song_mid": "004Fs2FP1EvZYc",
    "singer_name": "周杰伦"
  }
]

字段	类型	说明
`song_title`	string	歌曲名
`pay`	string	付费标记（"付费"/"免费"）
`song_mid`	string	歌曲mid（详情请求必需参数）
`singer_name`	string	歌手名

3.2 获取详情（播放URL + 歌词URL）

GET https://tang.api.s01s.cn/music_open_api.php

参数	类型	必填	说明
`msg`	string	是	搜索关键词（与搜索时一致）
`type`	string	是	固定值 `json`
`mid`	string	是	搜索结果中的 `song_mid`

请求示例：

GET https://tang.api.s01s.cn/music_open_api.php?msg=晴天&type=json&mid=0039MnYb0qxYhV

响应：

[
  {
    "song_title": "晴天",
    "singer_name": "周杰伦",
    "song_mid": "0039MnYb0qxYhV",
    "pay": "付费",
    "song_play_url_sq": "https://dl.stream.qqmusic.qq.com/...",
    "song_play_url_hq": "https://dl.stream.qqmusic.qq.com/...",
    "song_play_url_standard": "https://dl.stream.qqmusic.qq.com/...",
    "kbps_sq": "FLAC",
    "kbps_hq": "320",
    "kbps_standard": "128",
    "lrc_url": "https://c.y.qq.com/...",
    "album_img": "https://y.gtimg.cn/..."
  }
]

字段	类型	说明
`song_title`	string	歌曲名
`singer_name`	string	歌手名
`song_mid`	string	歌曲mid
`song_play_url_sq`	string	无损音质播放URL（FLAC/APE，可能为空）
`song_play_url_pq`	string	母带音质播放URL（可能为空）
`song_play_url_hq`	string	高品质播放URL（320kbps，可能为空）
`song_play_url_standard`	string	标准品质播放URL（128kbps，可能为空）
`song_play_url_accom`	string	伴奏URL（可能为空）
`kbps_sq`	string	无损音质标签
`kbps_pq`	string	母带音质标签
`kbps_hq`	string	高品质标签
`kbps_standard`	string	标准品质标签
`lrc_url`	string	歌词URL
`album_img`	string	专辑封面URL

播放URL优先级： song_play_url_sq > song_play_url_pq > song_play_url_hq > song_play_url_standard

4. 酷我音乐（kuwo）

4.1 搜索

GET https://kw-api.cenguigui.cn/

参数	类型	必填	说明
`name`	string	是	搜索关键词，需 URL 编码
`page`	int	是	页码，从1开始
`limit`	int	是	每页数量

请求示例：

GET https://kw-api.cenguigui.cn/?name=晴天&page=1&limit=10

响应：

{
  "code": 200,
  "msg": "单曲搜索成功",
  "data": [
    {
      "rid": 228908,
      "pic": "https://img4.kuwo.cn/star/albumcover/600/...",
      "vid": "8132306",
      "name": "晴天",
      "artist": "周杰伦",
      "artistid": "336",
      "album": "叶惠美",
      "albumid": "1293",
      "lrc": "http://kw-api.cenguigui.cn?id=228908&type=lyr&format=all",
      "url": "http://kw-api.cenguigui.cn?id=228908&type=song&level=exhigh&format=mp3"
    }
  ]
}

字段	类型	说明
`code`	int	200=成功
`msg`	string	状态描述
`data`	array	搜索结果列表
`data[].rid`	int	歌曲ID（详情/歌词请求必需参数）
`data[].pic`	string	封面图URL
`data[].vid`	string	MV ID
`data[].name`	string	歌曲名
`data[].artist`	string	歌手名
`data[].artistid`	string	歌手ID
`data[].album`	string	专辑名
`data[].albumid`	string	专辑ID
`data[].lrc`	string	歌词API地址（可直接请求获取歌词文本）
`data[].url`	string	音频API地址（请求后获取实际播放URL）

4.2 获取播放URL

GET http://kw-api.cenguigui.cn

参数	类型	必填	说明
`id`	int	是	搜索结果中的 `rid`
`type`	string	是	固定值 `song`
`level`	string	是	音质等级：`exhigh`（极高）、`high`（高）、`standard`（标准）
`format`	string	是	格式：`mp3`、`flac` 等

请求示例：

GET http://kw-api.cenguigui.cn?id=228908&type=song&level=exhigh&format=mp3

响应： 该接口返回 302 重定向，Location 头即为实际的音频文件URL（.mp3 或 .m4a 地址）。

如果跟随重定向（allow_redirects=True），最终 response.url 即为音频直链。

4.3 获取歌词

GET http://kw-api.cenguigui.cn

参数	类型	必填	说明
`id`	int	是	搜索结果中的 `rid`
`type`	string	是	固定值 `lyr`
`format`	string	是	固定值 `all`

请求示例：

GET http://kw-api.cenguigui.cn?id=228908&type=lyr&format=all

响应： 直接返回 LRC 格式歌词文本：

[ti:晴天]
[ar:周杰伦]
[al:叶惠美]
[by:]
[00:00.00]晴天 - 周杰伦
[00:03.89]词：周杰伦
[00:07.78]曲：周杰伦
[00:17.48]故事的小黄花
[00:19.82]从出生那年就飘着
...

5. API 调用流程总结

5.1 完整播放/下载流程

搜索歌曲 → 选择歌曲 → 获取详情(播放URL+歌词URL) → 播放/下载

5.2 各源对比

源	搜索API	详情API	播放URL	歌词	稳定性
QQ	`tang.api.s01s.cn` + `mid`	同搜索 +`mid`	✅ 多音质可选	✅`lrc_url`	⭐⭐⭐⭐ 高
酷我	`kw-api.cenguigui.cn`	同域 `?type=song`	✅ 重定向获取	✅`?type=lyr`	⭐⭐⭐ 中
咪咕	`api.xcvts.cn` + `n`	同搜索 +`n`	⚠️ 常为空	⚠️ 常为空	⭐⭐ 低
网易云	`api.vkeys.cn`	同搜索 +`mid`	✅ 重定向获取	✅`?type=lyr`	⭐⭐⭐ 中

5.3 推荐

首选 QQ 音乐：详情接口返回完整，支持多音质（无损/高品/标准），歌词稳定
备选酷我：搜索结果丰富，播放URL通过重定向获取，歌词直接可用
咪咕和网易云：作为补充，成功率一般